Graph для Hotmail и Outlook: как получать письма через OAuth 2.0

Microsoft Graph (OAuth2.0) — это официальный и распространенный способ доступа к почтовым данным Microsoft. Он может использоваться для чтения писем из почтовых ящиков Hotmail, Outlook и других сервисов Microsoft. По сравнению с традиционными почтовыми протоколами Graph API лучше подходит для получения писем с кодами подтверждения, автоматического приема почты, массового управления аккаунтами и интеграции с системами.

Все аккаунты Hotmail/Outlook, предоставляемые Hotmail007, содержат Refresh Token и Client ID, которые можно использовать для получения почты через Graph (OAuth2.0). Если вам нужна массовая покупка аккаунтов Hotmail, аккаунты Hotmail оптом, аккаунты Outlook оптом или почтовые аккаунты Microsoft с поддержкой Graph, вы можете использовать Hotmail007 API для быстрого получения писем или самостоятельно подключиться к Microsoft Graph.

Содержание

1. Что такое получение почты через Microsoft Graph (OAuth2.0)

2. Почему для Graph нужны Refresh Token и Client ID

3. Как быстро получить последнее письмо через Hotmail007 API

4. Как самостоятельно подключиться к Microsoft Graph для чтения писем

5. Как выбрать подходящий способ получения почты

6. Важные замечания при использовании Graph
   

1. Что такое получение почты через Microsoft Graph (OAuth2.0)?

Microsoft Graph — это официальный API Microsoft, который позволяет получать доступ к письмам Outlook, контактам, календарям и другим данным аккаунта Microsoft.

В сценарии получения почты Hotmail/Outlook Graph (OAuth2.0) использует данные авторизации для чтения почтового ящика, а не только традиционные почтовые протоколы. Проще говоря, многие старые способы получения почты в основном используют адрес электронной почты и пароль для подключения к почтовому серверу. Graph требует Refresh Token и Client ID для авторизации перед чтением писем.

Этот способ подходит для получения писем с кодами подтверждения, автоматического приема почты, массового управления аккаунтами Hotmail/Outlook и подключения функции получения почты к собственной системе.

Если пользователь использует сторонний инструмент для получения почты, обычно нужно заполнить адрес почты, пароль, Refresh Token, Client ID и другие необходимые данные согласно требованиям инструмента.

2. Почему для Graph нужны Refresh Token и Client ID?

Graph (OAuth2.0) использует механизм авторизации для чтения почты. Для получения почты Hotmail/Outlook через Graph очень важны Refresh Token и Client ID.

• Refresh Token: используется для поддержания авторизации и получения доступа

• Client ID: используется для идентификации соответствующего авторизованного приложения

• Access Token: временно получается программой во время запроса; обычным пользователям обычно не нужно вводить его вручную

Все аккаунты Hotmail/Outlook, предоставляемые Hotmail007, содержат Refresh Token и Client ID. Обычный формат выдачи:

email:password:refreshToken:clientId

Этот формат можно использовать для получения последнего письма через Hotmail007 API, для сторонних инструментов получения почты или для собственного кода, подключенного к Microsoft Graph.

Обратите внимание: Refresh Token обычно действует около 3 месяцев с момента создания, в зависимости от фактического статуса авторизации аккаунта. Если Token истек или стал недействительным, необходимо заменить его на действительный Token или получить новую авторизационную информацию.

Некоторые пользователи на практике могут сталкиваться с проблемами запросов из-за сетевой среды или состояния IP. Если получение почты через Graph не работает, сначала проверьте Refresh Token, Client ID, формат аккаунта, параметры запроса и сетевую среду.

3. Как быстро получить последнее письмо через Hotmail007 API

Hotmail007 API подходит для быстрого получения последнего письма из указанного почтового ящика Hotmail/Outlook. Пользователь может заполнить параметры на странице документации API и скопировать созданную ссылку запроса или подключить API к программе для массовых запросов.

Документация API:

https://hotmail007.com/api-docs

В документации API найдите:

04 Get the latest email of the specified email account

Этот API получает последнее письмо указанного почтового аккаунта по данным аккаунта, папке почты и необязательному времени начала.

Адрес API:

https://gapi.hotmail007.com/open/mail/latest

Параметры запроса:

• clientKey: ваш API Key

• account: полные учетные данные в формате email:password:refreshToken:clientId

• folder: папка почты, поддерживаются только inbox или junkemail. inbox получает последнее письмо из входящих, junkemail получает последнее письмо из папки спама

• start_timestamp: необязательно, возвращает только письма, полученные после указанного Unix timestamp в секундах
  

3.1 Создать ссылку запроса на странице документации API

Для пользователей, которые не знакомы с программированием, можно напрямую использовать тестовый интерфейс в документации API.

После заполнения clientKey, account и folder в тестовом интерфейсе страница автоматически создаст пример запроса. Скопируйте созданную ссылку и откройте ее в браузере, чтобы увидеть последнее письмо.

Этот способ подходит для временной проверки почты, чтения писем с кодами подтверждения или быстрой проверки, может ли почтовый ящик Hotmail/Outlook нормально получать письма.

3.2 Вызов API через программу

Если нужно получать последние письма массово, можно подключить Hotmail007 API к своему скрипту или системе.

Пример на Python:

import requests

clientKey = "your_clientKey"
account = "email:password:refreshToken:clientId"
folder = "inbox"

url = "https://gapi.hotmail007.com/open/mail/latest"

resp = requests.get(
    url,
    params={
        "clientKey": clientKey,
        "account": account,
        "folder": folder
    }
)

print(resp.text)

Если нужно фильтровать письма по времени, добавьте start_timestamp:

import requests

clientKey = "your_clientKey"
account = "email:password:refreshToken:clientId"
folder = "inbox"
start_timestamp = 1710000000

url = "https://gapi.hotmail007.com/open/mail/latest"

resp = requests.get(
    url,
    params={
        "clientKey": clientKey,
        "account": account,
        "folder": folder,
        "start_timestamp": start_timestamp
    }
)

print(resp.text)

Этот способ подходит для получения писем с кодами подтверждения, приема писем регистрации на платформах, массового получения почты Hotmail и автоматизации Outlook.

4. Как самостоятельно подключиться к Microsoft Graph для чтения писем

Если вы хотите напрямую подключиться к официальному Microsoft Graph API, можно использовать Refresh Token и Client ID из полного формата аккаунта для выполнения авторизационного запроса, а затем читать входящие письма Outlook. По сравнению с Hotmail007 API, который в основном используется для быстрого получения последнего письма, прямое подключение к Microsoft Graph больше подходит для сценариев, где нужно получать несколько писем, фильтровать список писем или обрабатывать больше содержимого писем.

Основной процесс:

1. Подготовить полный формат аккаунта: email:password:refreshToken:clientId

2. Получить Refresh Token и Client ID из данных аккаунта

3. Получить временный доступ через endpoint OAuth2.0

4. Вызвать Microsoft Graph mail API для чтения писем из inbox

Пример на Python:

import requests


def get_access_token(refresh_token: str, client_id: str) -> str:
    res = requests.post(
        "https://login.microsoftonline.com/common/oauth2/v2.0/token",
        data={
            "client_id": client_id,
            "grant_type": "refresh_token",
            "refresh_token": refresh_token,
            "scope": "https://graph.microsoft.com/.default"
        }
    )
    res.raise_for_status()
    return res.json()["access_token"]


def print_inbox(access_token: str) -> None:
    res = requests.get(
        "https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages",
        headers={"Authorization": f"Bearer {access_token}"}
    )
    res.raise_for_status()

    for mail in res.json().get("value", []):
        print(f"Subject: {mail.get('subject')}")
        print(f"From: {mail.get('from', {}).get('emailAddress', {}).get('address')}")
        print(f"Text: {mail.get('bodyPreview')}")
        print("-" * 50)


account = "email:password:refreshToken:clientId"

parts = account.split(":")
refresh_token = parts[2]
client_id = parts[3]

access_token = get_access_token(refresh_token, client_id)
print_inbox(access_token)

5. Как выбрать подходящий способ получения почты?

Если вам нужно быстро посмотреть последнее письмо из почтового ящика Hotmail/Outlook, можно использовать Test Interface в документации Hotmail007 API. После заполнения параметров скопируйте созданный Request Example и откройте его в браузере.

Если вам нужно массово получать последние письма, можно напрямую вызывать Hotmail007 API и подключить его к скрипту или системе.

Если вам нужна более гибкая обработка писем, например чтение нескольких писем, фильтрация писем или разбор содержимого письма, можно напрямую подключиться к Microsoft Graph.

Кратко:

• Быстро посмотреть последнее письмо: используйте Test Interface Hotmail007 API

• Массово получать последние письма: вызывайте Hotmail007 API

• Настроить собственную логику обработки писем: подключитесь к Microsoft Graph
  

6. Важные замечания при использовании Graph

При использовании Microsoft Graph (OAuth2.0) или Hotmail007 API для получения почты рекомендуется проверить следующие данные:

• Формат account: email:password:refreshToken:clientId

• Действителен ли Refresh Token

• Правильно ли указан Client ID

• Указан ли folder как inbox или junkemail

• Правильно ли указан clientKey

• Полностью ли заполнены параметры запроса

• Стабильна ли сетевая среда

Refresh Token обычно действует около 3 месяцев с момента создания, в зависимости от фактического статуса авторизации аккаунта. Чтобы получение почты Hotmail/Outlook оставалось стабильным, рекомендуется регулярно проверять состояние Token.

Заключение

Microsoft Graph (OAuth2.0) сейчас является распространенным API-способом получения почты для Hotmail/Outlook. Он подходит для быстрого приема писем, получения писем с кодами подтверждения, автоматической обработки почты и массового управления почтовыми ящиками.

Все аккаунты Hotmail/Outlook, предоставляемые Hotmail007, содержат Refresh Token и Client ID. Обычный формат выдачи: email:password:refreshToken:clientId. Пользователи могут быстро получать последние письма через Hotmail007 API или напрямую подключиться к Microsoft Graph с помощью Refresh Token и Client ID.

Если вам нужна массовая покупка аккаунтов Hotmail, аккаунты Hotmail оптом, аккаунты Outlook оптом или аккаунты Microsoft с поддержкой Graph (OAuth2.0), Hotmail007 может предоставить аккаунты и поддержку API.